package com.yunyi.camunda.service;

import com.yunyi.camunda.pojo.Result;
import com.yunyi.camunda.pojo.vo.CompleteTaskRequest;
import com.yunyi.camunda.pojo.vo.RejectTaskRequest;
import com.yunyi.camunda.pojo.vo.TransferTaskRequest;

import java.util.Map;

/**
 * task操作
 *
 * @author yunyi
 */
public interface ProcessTaskService {
    /**
     * 完成/审批单个任务
     *
     * @param requestParam 请求参数
     * @return 任务所在节点信息
     */
    Result<Map<String, String>> completeSingleTask(CompleteTaskRequest requestParam);

    /**
     * 新增camunda的评论
     *
     * @param processInstanceId 流程实例id
     * @param taskId            任务id
     * @param comment           评论
     */
    void addComment(String processInstanceId, String taskId, String comment);

    /**
     * 转交待办任务
     *
     * @param requestParam 请求参数
     * @return Void
     */
    Result<Void> transferTask(TransferTaskRequest requestParam);

    /**
     * 驳回任务到上个节点
     *
     * @param requestParam 请求参数
     */
    Result<Void> rejectTask(RejectTaskRequest requestParam);

    /**
     * 领取任务
     *
     * @param taskId 任务id
     * @return 结果
     */
    Result<String> claimTask(String taskId);
}
